

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
  <meta charset="utf-8" />
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  
  <title>radosgw-admin – rados REST 网关的用户管理工具 &mdash; Ceph Documentation</title>
  

  
  <link rel="stylesheet" href="../../../_static/ceph.css" type="text/css" />
  <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="../../../_static/graphviz.css" type="text/css" />
  <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />

  
  
    <link rel="shortcut icon" href="../../../_static/favicon.ico"/>
  

  
  

  

  
  <!--[if lt IE 9]>
    <script src="../../../_static/js/html5shiv.min.js"></script>
  <![endif]-->
  
    
      <script type="text/javascript" id="documentation_options" data-url_root="../../../" src="../../../_static/documentation_options.js"></script>
        <script src="../../../_static/jquery.js"></script>
        <script src="../../../_static/underscore.js"></script>
        <script src="../../../_static/doctools.js"></script>
    
    <script type="text/javascript" src="../../../_static/js/theme.js"></script>

    
    <link rel="index" title="Index" href="../../../genindex/" />
    <link rel="search" title="Search" href="../../../search/" />
    <link rel="next" title="使用 QAT 为加密和压缩提速" href="../../../radosgw/qat-accel/" />
    <link rel="prev" title="radosgw – rados REST 风格的网关" href="../radosgw/" /> 
</head>

<body class="wy-body-for-nav">

   
  <header class="top-bar">
    

















<div role="navigation" aria-label="breadcrumbs navigation">

  <ul class="wy-breadcrumbs">
    
      <li><a href="../../../" class="icon icon-home"></a> &raquo;</li>
        
          <li><a href="../../../radosgw/">Ceph 对象网关</a> &raquo;</li>
        
      <li>radosgw-admin – rados REST 网关的用户管理工具</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
          
            <a href="../../../_sources/man/8/radosgw-admin.rst.txt" rel="nofollow"> View page source</a>
          
        
      </li>
    
  </ul>

  
  <hr/>
</div>
  </header>
  <div class="wy-grid-for-nav">
    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search"  style="background: #eee" >
          

          
            <a href="../../../">
          

          
            
            <img src="../../../_static/logo.png" class="logo" alt="Logo"/>
          
          </a>

          

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../../../search/" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        
        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../../start/intro/">Ceph 简介</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../install/">安装 Ceph</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../cephadm/">Cephadm</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../rados/">Ceph 存储集群</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../cephfs/">Ceph 文件系统</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../rbd/">Ceph 块设备</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../../../radosgw/">Ceph 对象网关</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/frontends/">HTTP 前端</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/placement/">存储池归置与存储类</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/multisite/">多站配置</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/multisite-sync-policy/">多站同步策略配置</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/pools/">存储池的配置</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/config-ref/">配置参考</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/admin/">管理指南</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/s3/">S3 API</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/rgw-cache/">Data caching and CDN</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/swift/">Swift API</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/adminops/">管理操作 API</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/api/">Python 接口</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/nfs/">通过 NFS 导出</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/keystone/">与 OpenStack Keystone 对接</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/barbican/">与 OpenStack Barbican 对接</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/vault/">与 HashiCorp Vault 对接</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/kmip/">KMIP Integration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/opa/">与 Open Policy Agent 对接</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/multitenancy/">多租户</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/compression/">压缩</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/ldap-auth/">LDAP 认证</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/encryption/">服务器端加密</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/bucketpolicy/">桶策略</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/dynamicresharding/">动态的桶索引重分片</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/mfa/">多因子认证</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/sync-modules/">同步模块</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/notifications/">Bucket Notifications</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/layout/">RADOS 中的数据布局</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/STS/">STS</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/STSLite/">STS Lite</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/keycloak/">Keycloak</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/role/">Role</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/session-tags/">Session Tags</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/orphans/">Orphan List and Associated Tooliing</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/oidc/">OpenID Connect Provider</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/troubleshooting/">故障排除</a></li>
<li class="toctree-l2"><a class="reference internal" href="../radosgw/">radosgw 手册页</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">radosgw-admin 手册页</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id1">提纲</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id2">描述</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id3">命令</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id4">选项</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id5">配额选项</a></li>
<li class="toctree-l3"><a class="reference internal" href="#orphans">捡漏（ Orphans ）选项</a></li>
<li class="toctree-l3"><a class="reference internal" href="#orphans-list-jobs"><code class="docutils literal notranslate"><span class="pre">orphans</span> <span class="pre">list-jobs</span></code> 选项</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id6">角色选项</a></li>
<li class="toctree-l3"><a class="reference internal" href="#pubsub">桶的通知、发布订阅（PubSub）选项</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id7">实例</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id8">使用范围</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id9">参考</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/qat-accel/">使用 QAT 为加密和压缩提速</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/s3select/">S3-select</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/lua-scripting/">Lua Scripting</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/d3n_datacache/">D3N Data Cache</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../../radosgw/cloud-transition/">Cloud Transition</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../../mgr/">Ceph 管理器守护进程</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../mgr/dashboard/">Ceph 仪表盘</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../api/">API 文档</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../architecture/">体系结构</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../dev/developer_guide/">开发者指南</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../dev/internals/">Ceph 内幕</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../governance/">项目管理</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../foundation/">Ceph 基金会</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../ceph-volume/">ceph-volume</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../releases/general/">Ceph 版本（总目录）</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../releases/">Ceph 版本（索引）</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../security/">Security</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../glossary/">Ceph 术语</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../jaegertracing/">Tracing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../translation_cn/">中文版翻译资源</a></li>
</ul>

            
          
        </div>
        
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../../../">Ceph</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
<div id="dev-warning" class="admonition note">
  <p class="first admonition-title">Notice</p>
  <p class="last">This document is for a development version of Ceph.</p>
</div>
  <div id="docubetter" align="right" style="padding: 5px; font-weight: bold;">
    <a href="https://pad.ceph.com/p/Report_Documentation_Bugs">Report a Documentation Bug</a>
  </div>

  
  <div class="section" id="radosgw-admin-rados-rest">
<h1>radosgw-admin – rados REST 网关的用户管理工具<a class="headerlink" href="#radosgw-admin-rados-rest" title="Permalink to this headline">¶</a></h1>
<div class="section" id="id1">
<h2>提纲<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
<div class="line-block">
<div class="line"><strong>radosgw-admin</strong> <em>command</em> [ <em>options</em> <em>…</em> ]</div>
</div>
</div>
<div class="section" id="id2">
<h2>描述<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
<p><strong class="program">radosgw-admin</strong> 是 RADOS 网关用户管理工具，可用于创建和修改用户。</p>
</div>
<div class="section" id="id3">
<h2>命令<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
<p><strong class="program">radosgw-admin</strong> 工具有很多命令，
可完成各种管理任务：</p>
<dl class="simple">
<dt><strong class="command">user create</strong></dt><dd><p>创建一个新用户。</p>
</dd>
<dt><strong class="command">user modify</strong></dt><dd><p>修改一个用户。</p>
</dd>
<dt><strong class="command">user info</strong></dt><dd><p>显示用户信息，
以及可能存在的子用户和密钥。</p>
</dd>
<dt><strong class="command">user rename</strong></dt><dd><p>重命名一个用户。</p>
</dd>
<dt><strong class="command">user rm</strong></dt><dd><p>删除一个用户。</p>
</dd>
<dt><strong class="command">user suspend</strong></dt><dd><p>暂停某用户。</p>
</dd>
<dt><strong class="command">user enable</strong></dt><dd><p>重新允许暂停的用户。</p>
</dd>
<dt><strong class="command">user check</strong></dt><dd><p>检查用户信息。</p>
</dd>
<dt><strong class="command">user stats</strong></dt><dd><p>显示配额子系统统计的用户状态。</p>
</dd>
<dt><strong class="command">user list</strong></dt><dd><p>罗列出所有用户。</p>
</dd>
<dt><strong class="command">caps add</strong></dt><dd><p>给用户分配能力。</p>
</dd>
<dt><strong class="command">caps rm</strong></dt><dd><p>删除用户能力。</p>
</dd>
<dt><strong class="command">subuser create</strong></dt><dd><p>新建一个子用户（适合使用 Swift API 的客户端）。</p>
</dd>
<dt><strong class="command">subuser modify</strong></dt><dd><p>修改子用户。</p>
</dd>
<dt><strong class="command">subuser rm</strong></dt><dd><p>删除子用户</p>
</dd>
<dt><strong class="command">key create</strong></dt><dd><p>新建访问密钥。</p>
</dd>
<dt><strong class="command">key rm</strong></dt><dd><p>删除访问密钥。</p>
</dd>
<dt><strong class="command">bucket list</strong></dt><dd><p>罗列所有桶，或者，如果给桶加 –bucket=&lt;bucket&gt; 选项就罗列其内的对象；
如果给桶加 –allow-unordered 选项、就不再排序，
对于有海量对象的桶生成结果的速度可能快得多。</p>
</dd>
<dt><strong class="command">bucket limit check</strong></dt><dd><p>显示桶的分片统计信息。</p>
</dd>
<dt><strong class="command">bucket link</strong></dt><dd><p>把桶关联到指定用户。</p>
</dd>
<dt><strong class="command">bucket unlink</strong></dt><dd><p>取消指定用户和桶的关联。</p>
</dd>
<dt><strong class="command">bucket chown</strong></dt><dd><p>把桶链接到指定对象、并更新 ACL 。
如果命令被中断，用 –marker 继续执行。</p>
</dd>
<dt><strong class="command">bucket stats</strong></dt><dd><p>返回桶的统计信息。</p>
</dd>
<dt><strong class="command">bucket rm</strong></dt><dd><p>删除一个桶。</p>
</dd>
<dt><strong class="command">bucket check</strong></dt><dd><p>检查桶的索引信息。</p>
</dd>
<dt><strong class="command">bucket rewrite</strong></dt><dd><p>重写指定桶内的所有对象。</p>
</dd>
<dt><strong class="command">bucket radoslist</strong></dt><dd><p>如果指定了 –bucket=&lt;bucket&gt; ，
就罗列出与这个桶内所有对象数据相关的 rados 对象，
否则就罗列出所有桶的。</p>
</dd>
<dt><strong class="command">bucket reshard</strong></dt><dd><p>对桶进行重分片。</p>
</dd>
<dt><strong class="command">bucket sync disable</strong></dt><dd><p>禁用桶同步。</p>
</dd>
<dt><strong class="command">bucket sync enable</strong></dt><dd><p>允许桶同步。</p>
</dd>
<dt><strong class="command">bi get</strong></dt><dd><p>检出桶索引对象条目。</p>
</dd>
<dt><strong class="command">bi put</strong></dt><dd><p>存入桶索引对象条目。</p>
</dd>
<dt><strong class="command">bi list</strong></dt><dd><p>罗列原始的桶索引条目。</p>
</dd>
<dt><strong class="command">bi purge</strong></dt><dd><p>清除桶索引条目。</p>
</dd>
<dt><strong class="command">object rm</strong></dt><dd><p>删除一个对象。</p>
</dd>
<dt><strong class="command">object stat</strong></dt><dd><p>对某一对象执行 stat 操作，查看其元数据。</p>
</dd>
<dt><strong class="command">object unlink</strong></dt><dd><p>从桶索引里去掉对象。</p>
</dd>
<dt><strong class="command">object rewrite</strong></dt><dd><p>重写指定对象。</p>
</dd>
<dt><strong class="command">objects expire</strong></dt><dd><p>启动过期对象的清理。</p>
</dd>
<dt><strong class="command">period rm</strong></dt><dd><p>删除一个 period 。</p>
</dd>
<dt><strong class="command">period get</strong></dt><dd><p>查看指定 period 的信息。</p>
</dd>
<dt><strong class="command">period get-current</strong></dt><dd><p>查看当前 period 的信息。</p>
</dd>
<dt><strong class="command">period pull</strong></dt><dd><p>拉取一个 period 。</p>
</dd>
<dt><strong class="command">period push</strong></dt><dd><p>推送一个 period 。</p>
</dd>
<dt><strong class="command">period list</strong></dt><dd><p>罗列所有 period 。</p>
</dd>
<dt><strong class="command">period update</strong></dt><dd><p>更新暂存的 period 。</p>
</dd>
<dt><strong class="command">period commit</strong></dt><dd><p>提交暂存的 period 。</p>
</dd>
<dt><strong class="command">quota set</strong></dt><dd><p>设置配额参数。</p>
</dd>
<dt><strong class="command">quota enable</strong></dt><dd><p>启用配额。</p>
</dd>
<dt><strong class="command">quota disable</strong></dt><dd><p>禁用配额。</p>
</dd>
<dt><strong class="command">global quota get</strong></dt><dd><p>查看全局配额参数。</p>
</dd>
<dt><strong class="command">global quota set</strong></dt><dd><p>配置全局配额参数。</p>
</dd>
<dt><strong class="command">global quota enable</strong></dt><dd><p>启用全局配额。</p>
</dd>
<dt><strong class="command">global quota disable</strong></dt><dd><p>禁用全局配额。</p>
</dd>
<dt><strong class="command">realm create</strong></dt><dd><p>新建一个 realm 。</p>
</dd>
<dt><strong class="command">realm rm</strong></dt><dd><p>删除一个 realm 。</p>
</dd>
<dt><strong class="command">realm get</strong></dt><dd><p>显示此 realm 的信息。</p>
</dd>
<dt><strong class="command">realm get-default</strong></dt><dd><p>查看默认的 realm 名。</p>
</dd>
<dt><strong class="command">realm list</strong></dt><dd><p>罗列所有 realm 。</p>
</dd>
<dt><strong class="command">realm list-periods</strong></dt><dd><p>罗列所有 realm 的 period 。</p>
</dd>
<dt><strong class="command">realm rename</strong></dt><dd><p>重命名一个 realm 。</p>
</dd>
<dt><strong class="command">realm set</strong></dt><dd><p>设置 realm 信息（需要信息源 infile ）。</p>
</dd>
<dt><strong class="command">realm default</strong></dt><dd><p>把此 realm 设置为默认的。</p>
</dd>
<dt><strong class="command">realm pull</strong></dt><dd><p>拉取一个 realm 、及其当前的 period 。</p>
</dd>
<dt><strong class="command">zonegroup add</strong></dt><dd><p>把一个域加入域组。</p>
</dd>
<dt><strong class="command">zonegroup create</strong></dt><dd><p>新建一条域组信息。</p>
</dd>
<dt><strong class="command">zonegroup default</strong></dt><dd><p>设置默认域组。</p>
</dd>
<dt><strong class="command">zonegroup rm</strong></dt><dd><p>删除一条域组信息。</p>
</dd>
<dt><strong class="command">zonegroup get</strong></dt><dd><p>显示域组信息。</p>
</dd>
<dt><strong class="command">zonegroup modify</strong></dt><dd><p>更改现有域组。</p>
</dd>
<dt><strong class="command">zonegroup set</strong></dt><dd><p>设置域组信息（需要信息源 infile ）。</p>
</dd>
<dt><strong class="command">zonegroup remove</strong></dt><dd><p>从一域组中删除一个域。</p>
</dd>
<dt><strong class="command">zonegroup rename</strong></dt><dd><p>重命名一个域组。</p>
</dd>
<dt><strong class="command">zonegroup list</strong></dt><dd><p>罗列此集群内配置的所有域组。</p>
</dd>
<dt><strong class="command">zonegroup placement list</strong></dt><dd><p>罗列域组的归置靶。</p>
</dd>
<dt><strong class="command">zonegroup placement add</strong></dt><dd><p>把一个归置靶 id 加进一个域组。</p>
</dd>
<dt><strong class="command">zonegroup placement modify</strong></dt><dd><p>更改某一特定域组内的一个归置靶。</p>
</dd>
<dt><strong class="command">zonegroup placement rm</strong></dt><dd><p>删除一个域组的一个归置靶。</p>
</dd>
<dt><strong class="command">zonegroup placement default</strong></dt><dd><p>设置一域组的默认归置靶。</p>
</dd>
<dt><strong class="command">zone create</strong></dt><dd><p>新建一个域。</p>
</dd>
<dt><strong class="command">zone rm</strong></dt><dd><p>删除一个域。</p>
</dd>
<dt><strong class="command">zone get</strong></dt><dd><p>显示区域集群参数。</p>
</dd>
<dt><strong class="command">zone set</strong></dt><dd><p>设置区域集群参数（需要输入文件）。</p>
</dd>
<dt><strong class="command">zone modify</strong></dt><dd><p>更改现有域。</p>
</dd>
<dt><strong class="command">zone list</strong></dt><dd><p>列出本集群内配置的所有区域。</p>
</dd>
<dt><strong class="command">metadata sync status</strong></dt><dd><p>查看元数据同步状态。</p>
</dd>
<dt><strong class="command">metadata sync init</strong></dt><dd><p>初始化元数据同步。</p>
</dd>
<dt><strong class="command">metadata sync run</strong></dt><dd><p>启动元数据同步。</p>
</dd>
<dt><strong class="command">data sync status</strong></dt><dd><p>查看指定源 zone 的数据同步状态。</p>
</dd>
<dt><strong class="command">data sync init</strong></dt><dd><p>初始化指定源 zone 的数据同步。</p>
</dd>
<dt><strong class="command">data sync run</strong></dt><dd><p>启动指定源 zone 的数据同步。</p>
</dd>
<dt><strong class="command">sync error list</strong></dt><dd><p>罗列同步错误。</p>
</dd>
<dt><strong class="command">sync error trim</strong></dt><dd><p>清理同步错误。</p>
</dd>
<dt><strong class="command">zone rename</strong></dt><dd><p>重命名一个 zone 。</p>
</dd>
<dt><strong class="command">zone placement list</strong></dt><dd><p>罗列 zone 的归置靶。</p>
</dd>
<dt><strong class="command">zone placement add</strong></dt><dd><p>新增一个 zone 归置靶。</p>
</dd>
<dt><strong class="command">zone placement modify</strong></dt><dd><p>更改一个 zone 的归置靶。</p>
</dd>
<dt><strong class="command">zone placement rm</strong></dt><dd><p>删除一个 zone 的归置靶。</p>
</dd>
<dt><strong class="command">pool add</strong></dt><dd><p>增加一个已有存储池用于数据归置。</p>
</dd>
<dt><strong class="command">pool rm</strong></dt><dd><p>从数据归置集删除一个已有存储池。</p>
</dd>
<dt><strong class="command">pools list</strong></dt><dd><p>罗列归置活跃集。</p>
</dd>
<dt><strong class="command">policy</strong></dt><dd><p>显示桶或对象相关的策略。</p>
</dd>
<dt><strong class="command">log list</strong></dt><dd><p>罗列日志对象。</p>
</dd>
<dt><strong class="command">log show</strong></dt><dd><p>显示指定对象内（或指定桶、日期、桶标识符）的日志。
（注意：日期格式必须是 YYYY-MM-DD-hh ）</p>
</dd>
<dt><strong class="command">log rm</strong></dt><dd><p>删除日志对象。</p>
</dd>
<dt><strong class="command">usage show</strong></dt><dd><p>查看使用率信息（可选选项有用户和数据范围）。</p>
</dd>
<dt><strong class="command">usage trim</strong></dt><dd><p>修剪使用率信息（可选选项有用户和数据范围）。</p>
</dd>
<dt><strong class="command">gc list</strong></dt><dd><p>显示过期的垃圾回收对象（加 –include-all 选项罗列所有条目，包括未过期的）。</p>
</dd>
<dt><strong class="command">gc process</strong></dt><dd><p>手动处理垃圾。</p>
</dd>
<dt><strong class="command">lc list</strong></dt><dd><p>罗列所有桶的生命周期进度。如果指定了桶
（如通过 –bucket_id 或 –bucket ，和可选的 –tenant ），
就只处理那个桶的。</p>
</dd>
<dt><strong class="command">lc process</strong></dt><dd><p>手动处理生命周期。如果指定了桶（例如，
用 –bucket_id 或 –bucket 和可选的 –tenant ），
就只处理那个桶的。</p>
</dd>
<dt><strong class="command">metadata get</strong></dt><dd><p>读取元数据信息。</p>
</dd>
<dt><strong class="command">metadata put</strong></dt><dd><p>设置元数据信息。</p>
</dd>
<dt><strong class="command">metadata rm</strong></dt><dd><p>删除元数据信息。</p>
</dd>
<dt><strong class="command">metadata list</strong></dt><dd><p>罗列元数据信息。</p>
</dd>
<dt><strong class="command">mdlog list</strong></dt><dd><p>罗列元数据日志，多站部署需要。</p>
</dd>
<dt><strong class="command">mdlog trim</strong></dt><dd><p>手动裁截元数据日志，而不是依赖 RGW 集成的日志同步机制。
裁截前，罗列几次查验一下，确保最后一个同步已完成，
否则它会重新开始一个同步。</p>
</dd>
<dt><strong class="command">mdlog status</strong></dt><dd><p>读取元数据日志状态。</p>
</dd>
<dt><strong class="command">bilog list</strong></dt><dd><p>罗列桶索引日志，多站部署需要。</p>
</dd>
<dt><strong class="command">bilog trim</strong></dt><dd><p>手动裁截桶索引日志（要用到起始标记、结束标记），
而不是依赖 RGW 自带的日志同步机制。
裁截前，罗列几次查验一下，确保最后一个同步已完成，
否则它会重新开始一个同步。</p>
</dd>
<dt><strong class="command">datalog list</strong></dt><dd><p>罗列数据日志，多站部署需要。</p>
</dd>
<dt><strong class="command">datalog trim</strong></dt><dd><p>手动裁截数据日志，而不是依赖 RGW 自带的日志同步机制。
裁截前，罗列几次查验一下，确保最后一个同步已完成，
否则它会重新开始一个同步。</p>
</dd>
<dt><strong class="command">datalog status</strong></dt><dd><p>读取数据日志状态。</p>
</dd>
<dt><strong class="command">orphans find</strong></dt><dd><p>初始化、并开始检索遗漏的 RADOS 对象。
<strong>已废弃</strong>，改用 rgw-orphan-list 工具吧。</p>
</dd>
<dt><strong class="command">orphans finish</strong></dt><dd><p>清理遗漏 RADOS 对象的检索结果。
<strong>已废弃</strong>，改用 rgw-orphan-list 工具吧。</p>
</dd>
<dt><strong class="command">orphans list-jobs</strong></dt><dd><p>罗列当前正在进行的遗漏对象检索作业号。
<strong>已废弃</strong>，改用 rgw-orphan-list 工具吧。</p>
</dd>
<dt><strong class="command">role create</strong></dt><dd><p>新建一个用于 STS 的 AWS 角色。</p>
</dd>
<dt><strong class="command">role rm</strong></dt><dd><p>删除一个角色。</p>
</dd>
<dt><strong class="command">role get</strong></dt><dd><p>获取一个角色。</p>
</dd>
<dt><strong class="command">role list</strong></dt><dd><p>罗列带有指定路径前缀的角色。</p>
</dd>
<dt><strong class="command">role modify</strong></dt><dd><p>修改现有角色的 assume role 策略。</p>
</dd>
<dt><strong class="command">role-policy put</strong></dt><dd><p>新增、更新角色的权限策略。</p>
</dd>
<dt><strong class="command">role-policy list</strong></dt><dd><p>罗列与一个角色相关的策略。</p>
</dd>
<dt><strong class="command">role-policy get</strong></dt><dd><p>获取给定角色内嵌的指定内联策略文档。</p>
</dd>
<dt><strong class="command">role-policy rm</strong></dt><dd><p>删除与一个角色相关的策略。</p>
</dd>
<dt><strong class="command">reshard add</strong></dt><dd><p>安排一个桶进行重分片。</p>
</dd>
<dt><strong class="command">reshard list</strong></dt><dd><p>罗列所有正在进行的桶重分片、或已安排准备重分片的作业。</p>
</dd>
<dt><strong class="command">reshard process</strong></dt><dd><p>已安排重分片作业的进度。</p>
</dd>
<dt><strong class="command">reshard status</strong></dt><dd><p>一个桶的重分片状态。</p>
</dd>
<dt><strong class="command">reshard cancel</strong></dt><dd><p>取消一个桶的重分片。</p>
</dd>
<dt><strong class="command">topic list</strong></dt><dd><p>罗列桶的通知、发布订阅话题；</p>
</dd>
<dt><strong class="command">topic get</strong></dt><dd><p>查看一个桶的通知、发布订阅话题；</p>
</dd>
<dt><strong class="command">topic rm</strong></dt><dd><p>删除一个桶的通知、发布订阅话题；</p>
</dd>
<dt><strong class="command">subscription get</strong></dt><dd><p>查看发布订阅的配置情况；</p>
</dd>
<dt><strong class="command">subscription rm</strong></dt><dd><p>删除一个订阅条目；</p>
</dd>
<dt><strong class="command">subscription pull</strong></dt><dd><p>展示发布订阅里的事件；</p>
</dd>
<dt><strong class="command">subscription ack</strong></dt><dd><p>签收（删除）一个订阅里的事件。</p>
</dd>
</dl>
</div>
<div class="section" id="id4">
<h2>选项<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2>
<dl class="std option">
<dt id="cmdoption-radosgw-admin-c">
<span id="cmdoption-radosgw-admin-conf"></span><code class="sig-name descname"><span class="pre">-c</span></code><code class="sig-prename descclassname"> <span class="pre">ceph.conf</span></code><code class="sig-prename descclassname"><span class="pre">,</span> </code><code class="sig-name descname"><span class="pre">--conf</span></code><code class="sig-prename descclassname"><span class="pre">=ceph.conf</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-c" title="Permalink to this definition">¶</a></dt>
<dd><p>用指定的 <code class="docutils literal notranslate"><span class="pre">ceph.conf</span></code> 配置文件而非默认的
<code class="docutils literal notranslate"><span class="pre">/etc/ceph/ceph.conf</span></code> 来确定启动时所需的监视器地址。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-m">
<code class="sig-name descname"><span class="pre">-m</span></code><code class="sig-prename descclassname"> <span class="pre">monaddress[:port]</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-m" title="Permalink to this definition">¶</a></dt>
<dd><p>连接到指定监视器，而非通过 ceph.conf 查询。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-tenant">
<code class="sig-name descname"><span class="pre">--tenant</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;tenant&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-tenant" title="Permalink to this definition">¶</a></dt>
<dd><p>租户的名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-uid">
<code class="sig-name descname"><span class="pre">--uid</span></code><code class="sig-prename descclassname"><span class="pre">=uid</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-uid" title="Permalink to this definition">¶</a></dt>
<dd><p>radosgw 用户的 ID 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-new-uid">
<code class="sig-name descname"><span class="pre">--new-uid</span></code><code class="sig-prename descclassname"><span class="pre">=uid</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-new-uid" title="Permalink to this definition">¶</a></dt>
<dd><p>新用户的 ID ， <code class="docutils literal notranslate"><span class="pre">user</span> <span class="pre">rename</span></code> 命令用到此选项。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-subuser">
<code class="sig-name descname"><span class="pre">--subuser</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;name&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-subuser" title="Permalink to this definition">¶</a></dt>
<dd><p>子用户名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-access-key">
<code class="sig-name descname"><span class="pre">--access-key</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;key&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-access-key" title="Permalink to this definition">¶</a></dt>
<dd><p>S3 访问密钥。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-email">
<code class="sig-name descname"><span class="pre">--email</span></code><code class="sig-prename descclassname"><span class="pre">=email</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-email" title="Permalink to this definition">¶</a></dt>
<dd><p>用户的电子邮件地址。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-secret-secret-key">
<code class="sig-name descname"><span class="pre">--secret/--secret-key</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;key&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-secret-secret-key" title="Permalink to this definition">¶</a></dt>
<dd><p>私钥。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-gen-access-key">
<code class="sig-name descname"><span class="pre">--gen-access-key</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-gen-access-key" title="Permalink to this definition">¶</a></dt>
<dd><p>生成随机访问密钥（给 S3 ）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-gen-secret">
<code class="sig-name descname"><span class="pre">--gen-secret</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-gen-secret" title="Permalink to this definition">¶</a></dt>
<dd><p>生成随机私钥。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-key-type">
<code class="sig-name descname"><span class="pre">--key-type</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;type&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-key-type" title="Permalink to this definition">¶</a></dt>
<dd><p>密钥类型，可用的有： swift 、 s3 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-temp-url-key-2">
<code class="sig-name descname"><span class="pre">--temp-url-key[-2]</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;key&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-temp-url-key-2" title="Permalink to this definition">¶</a></dt>
<dd><p>临时 URL 密钥。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-max-buckets">
<code class="sig-name descname"><span class="pre">--max-buckets</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-max-buckets" title="Permalink to this definition">¶</a></dt>
<dd><p>一用户的最大桶数量（ 0 意为不限制，负值意为禁止创建桶）。
默认为 1000 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-access">
<code class="sig-name descname"><span class="pre">--access</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;access&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-access" title="Permalink to this definition">¶</a></dt>
<dd><p>为子用户设置访问权限。
可用的访问权限有读、写、读写和完全。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-display-name">
<code class="sig-name descname"><span class="pre">--display-name</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;name&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-display-name" title="Permalink to this definition">¶</a></dt>
<dd><p>此用户的显示名字（昵称）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-admin">
<code class="sig-name descname"><span class="pre">--admin</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-admin" title="Permalink to this definition">¶</a></dt>
<dd><p>给用户设置管理标志。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-system">
<code class="sig-name descname"><span class="pre">--system</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-system" title="Permalink to this definition">¶</a></dt>
<dd><p>给用户设置系统标识。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-bucket">
<code class="sig-name descname"><span class="pre">--bucket</span></code><code class="sig-prename descclassname"><span class="pre">=[tenant-id/]bucket</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-bucket" title="Permalink to this definition">¶</a></dt>
<dd><p>指定桶名。如果未指定 tenant-id ，
那就用用户（ –uid ）的 tenant-id 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-pool">
<code class="sig-name descname"><span class="pre">--pool</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;pool&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-pool" title="Permalink to this definition">¶</a></dt>
<dd><p>指定存储池名字。也可以用于 <cite>orphans find</cite> 指定数据存储池，以扫描泄露的 rados 对象。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-object">
<code class="sig-name descname"><span class="pre">--object</span></code><code class="sig-prename descclassname"><span class="pre">=object</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-object" title="Permalink to this definition">¶</a></dt>
<dd><p>指定对象名</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-date">
<code class="sig-name descname"><span class="pre">--date</span></code><code class="sig-prename descclassname"><span class="pre">=yyyy-mm-dd</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-date" title="Permalink to this definition">¶</a></dt>
<dd><p>格式为 yyyy-mm-dd 的日期。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-start-date">
<code class="sig-name descname"><span class="pre">--start-date</span></code><code class="sig-prename descclassname"><span class="pre">=yyyy-mm-dd</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-start-date" title="Permalink to this definition">¶</a></dt>
<dd><p>格式为 yyyy-mm-dd 的起始日期。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-end-date">
<code class="sig-name descname"><span class="pre">--end-date</span></code><code class="sig-prename descclassname"><span class="pre">=yyyy-mm-dd</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-end-date" title="Permalink to this definition">¶</a></dt>
<dd><p>格式为 yyyy-mm-dd 的终结日期。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-bucket-id">
<code class="sig-name descname"><span class="pre">--bucket-id</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;bucket-id&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-bucket-id" title="Permalink to this definition">¶</a></dt>
<dd><p>指定桶 id 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-bucket-new-name">
<code class="sig-name descname"><span class="pre">--bucket-new-name</span></code><code class="sig-prename descclassname"><span class="pre">=[tenant-id/]&lt;bucket&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-bucket-new-name" title="Permalink to this definition">¶</a></dt>
<dd><p><cite>bucket link</cite> 命令的可选项，用于重命名一个桶。
tenant-id/ 可加可不加，常规操作一般没必要管。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-shard-id">
<code class="sig-name descname"><span class="pre">--shard-id</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;shard-id&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-shard-id" title="Permalink to this definition">¶</a></dt>
<dd><p><code class="docutils literal notranslate"><span class="pre">mdlog</span> <span class="pre">list</span></code> 、 <code class="docutils literal notranslate"><span class="pre">bi</span> <span class="pre">list</span></code> 、 <code class="docutils literal notranslate"><span class="pre">data</span> <span class="pre">sync</span> <span class="pre">status</span></code> 命令的可选项。
对 <code class="docutils literal notranslate"><span class="pre">mdlog</span> <span class="pre">trim</span></code> 来说是必需的。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-max-entries">
<code class="sig-name descname"><span class="pre">--max-entries</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;entries&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-max-entries" title="Permalink to this definition">¶</a></dt>
<dd><p>罗列操作的可选参数，用于指定最大条数。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-purge-data">
<code class="sig-name descname"><span class="pre">--purge-data</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-purge-data" title="Permalink to this definition">¶</a></dt>
<dd><p>若加了此选项，删除用户时也一并删除用户的所有数据。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-purge-keys">
<code class="sig-name descname"><span class="pre">--purge-keys</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-purge-keys" title="Permalink to this definition">¶</a></dt>
<dd><p>若加了此选项，删除子用户时将一起删除其所有密钥。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-purge-objects">
<code class="sig-name descname"><span class="pre">--purge-objects</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-purge-objects" title="Permalink to this definition">¶</a></dt>
<dd><p>若加了此选项，删除此桶时也一并删除其内所有对象。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-metadata-key">
<code class="sig-name descname"><span class="pre">--metadata-key</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;key&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-metadata-key" title="Permalink to this definition">¶</a></dt>
<dd><p>用 <code class="docutils literal notranslate"><span class="pre">metadata</span> <span class="pre">get</span></code> 检索元数据时用的密钥。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-remote">
<code class="sig-name descname"><span class="pre">--remote</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;remote&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-remote" title="Permalink to this definition">¶</a></dt>
<dd><p>远程网关的域或域组 id 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-period">
<code class="sig-name descname"><span class="pre">--period</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;id&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-period" title="Permalink to this definition">¶</a></dt>
<dd><p>Period id.</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-url">
<code class="sig-name descname"><span class="pre">--url</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;url&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-url" title="Permalink to this definition">¶</a></dt>
<dd><p>用于推送、拉取 period 或 realm 的 URL 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-epoch">
<code class="sig-name descname"><span class="pre">--epoch</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;number&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-epoch" title="Permalink to this definition">¶</a></dt>
<dd><p>Period epoch.</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-commit">
<code class="sig-name descname"><span class="pre">--commit</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-commit" title="Permalink to this definition">¶</a></dt>
<dd><p>在执行 <code class="docutils literal notranslate"><span class="pre">period</span> <span class="pre">update</span></code> 期间提交此 period 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-staging">
<code class="sig-name descname"><span class="pre">--staging</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-staging" title="Permalink to this definition">¶</a></dt>
<dd><p>查看暂存的 period 信息。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-master">
<code class="sig-name descname"><span class="pre">--master</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-master" title="Permalink to this definition">¶</a></dt>
<dd><p>设置为 master 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-master-zone">
<code class="sig-name descname"><span class="pre">--master-zone</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;id&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-master-zone" title="Permalink to this definition">¶</a></dt>
<dd><p>主域的 id 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-rgw-realm">
<code class="sig-name descname"><span class="pre">--rgw-realm</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;name&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-rgw-realm" title="Permalink to this definition">¶</a></dt>
<dd><p>realm 的名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-realm-id">
<code class="sig-name descname"><span class="pre">--realm-id</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;id&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-realm-id" title="Permalink to this definition">¶</a></dt>
<dd><p>realm 的 id 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-realm-new-name">
<code class="sig-name descname"><span class="pre">--realm-new-name</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;name&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-realm-new-name" title="Permalink to this definition">¶</a></dt>
<dd><p>realm 的新名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-rgw-zonegroup">
<code class="sig-name descname"><span class="pre">--rgw-zonegroup</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;name&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-rgw-zonegroup" title="Permalink to this definition">¶</a></dt>
<dd><p>域组的名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-zonegroup-id">
<code class="sig-name descname"><span class="pre">--zonegroup-id</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;id&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-zonegroup-id" title="Permalink to this definition">¶</a></dt>
<dd><p>域组的 id 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-zonegroup-new-name">
<code class="sig-name descname"><span class="pre">--zonegroup-new-name</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;name&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-zonegroup-new-name" title="Permalink to this definition">¶</a></dt>
<dd><p>域组的新名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-rgw-zone">
<code class="sig-name descname"><span class="pre">--rgw-zone</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;zone&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-rgw-zone" title="Permalink to this definition">¶</a></dt>
<dd><p>radosgw 所在的区域。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-zone-id">
<code class="sig-name descname"><span class="pre">--zone-id</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;id&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-zone-id" title="Permalink to this definition">¶</a></dt>
<dd><p>域的 id 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-zone-new-name">
<code class="sig-name descname"><span class="pre">--zone-new-name</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;name&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-zone-new-name" title="Permalink to this definition">¶</a></dt>
<dd><p>此域的新名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-source-zone">
<code class="sig-name descname"><span class="pre">--source-zone</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-source-zone" title="Permalink to this definition">¶</a></dt>
<dd><p>数据同步的源 zone 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-default">
<code class="sig-name descname"><span class="pre">--default</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-default" title="Permalink to this definition">¶</a></dt>
<dd><p>把实体（ realm, zonegroup, zone ）设置成默认的。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-read-only">
<code class="sig-name descname"><span class="pre">--read-only</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-read-only" title="Permalink to this definition">¶</a></dt>
<dd><p>把域加进域组时设置成只读的。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-placement-id">
<code class="sig-name descname"><span class="pre">--placement-id</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-placement-id" title="Permalink to this definition">¶</a></dt>
<dd><p><code class="docutils literal notranslate"><span class="pre">zonegroup</span> <span class="pre">placement</span></code> 命令的归置 id 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-tags">
<code class="sig-name descname"><span class="pre">--tags</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;list&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-tags" title="Permalink to this definition">¶</a></dt>
<dd><p><code class="docutils literal notranslate"><span class="pre">zonegroup</span> <span class="pre">placement</span> <span class="pre">add</span></code> 和 <code class="docutils literal notranslate"><span class="pre">modify</span></code> 命令可以加的标签串。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-tags-add">
<code class="sig-name descname"><span class="pre">--tags-add</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;list&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-tags-add" title="Permalink to this definition">¶</a></dt>
<dd><p><code class="docutils literal notranslate"><span class="pre">zonegroup</span> <span class="pre">placement</span> <span class="pre">modify</span></code> 命令要新加的标签串。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-tags-rm">
<code class="sig-name descname"><span class="pre">--tags-rm</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;list&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-tags-rm" title="Permalink to this definition">¶</a></dt>
<dd><p><code class="docutils literal notranslate"><span class="pre">zonegroup</span> <span class="pre">placement</span> <span class="pre">modify</span></code> 命令要删除的标签串。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-endpoints">
<code class="sig-name descname"><span class="pre">--endpoints</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;list&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-endpoints" title="Permalink to this definition">¶</a></dt>
<dd><p>域的终结点。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-index-pool">
<code class="sig-name descname"><span class="pre">--index-pool</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;pool&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-index-pool" title="Permalink to this definition">¶</a></dt>
<dd><p>归置靶的索引存储池。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-data-pool">
<code class="sig-name descname"><span class="pre">--data-pool</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;pool&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-data-pool" title="Permalink to this definition">¶</a></dt>
<dd><p>归置靶的数据存储池。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-data-extra-pool">
<code class="sig-name descname"><span class="pre">--data-extra-pool</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;pool&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-data-extra-pool" title="Permalink to this definition">¶</a></dt>
<dd><p>归置靶的附加数据存储池（非 EC ）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-placement-index-type">
<code class="sig-name descname"><span class="pre">--placement-index-type</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;type&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-placement-index-type" title="Permalink to this definition">¶</a></dt>
<dd><p>归置靶的索引类型（ normal 、 indexless 或 #id ）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-tier-type">
<code class="sig-name descname"><span class="pre">--tier-type</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;type&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-tier-type" title="Permalink to this definition">¶</a></dt>
<dd><p>zone tier 类型。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-tier-config">
<code class="sig-name descname"><span class="pre">--tier-config</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;k&gt;=&lt;v&gt;[,...]</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-tier-config" title="Permalink to this definition">¶</a></dt>
<dd><p>设置 zone tier 的键值对。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-tier-config-rm">
<code class="sig-name descname"><span class="pre">--tier-config-rm</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;k&gt;[,...]</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-tier-config-rm" title="Permalink to this definition">¶</a></dt>
<dd><p>取消 zone tier 配置的键值对。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-sync-from-all">
<code class="sig-name descname"><span class="pre">--sync-from-all</span></code><code class="sig-prename descclassname"><span class="pre">[=false]</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-sync-from-all" title="Permalink to this definition">¶</a></dt>
<dd><p>设置/重置域是否从所有域组节点同步。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-sync-from">
<code class="sig-name descname"><span class="pre">--sync-from</span></code><code class="sig-prename descclassname"><span class="pre">=[zone-name][,...]</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-sync-from" title="Permalink to this definition">¶</a></dt>
<dd><p>设置从哪些域同步。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-sync-from-rm">
<code class="sig-name descname"><span class="pre">--sync-from-rm</span></code><code class="sig-prename descclassname"><span class="pre">=[zone-name][,...]</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-sync-from-rm" title="Permalink to this definition">¶</a></dt>
<dd><p>删除同步的源域。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-bucket-index-max-shards">
<code class="sig-name descname"><span class="pre">--bucket-index-max-shards</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-bucket-index-max-shards" title="Permalink to this definition">¶</a></dt>
<dd><p>覆盖一个域或域组的桶索引分片默认数值。
<code class="docutils literal notranslate"><span class="pre">zone</span> <span class="pre">create</span></code> 、 <code class="docutils literal notranslate"><span class="pre">zone</span> <span class="pre">modify</span></code> 、 <code class="docutils literal notranslate"><span class="pre">zonegroup</span> <span class="pre">add</span></code> 和
<code class="docutils literal notranslate"><span class="pre">zonegroup</span> <span class="pre">modify</span></code> 命令接受这个参数，
并且会自动应用到 zone/zonegroup 变更生效之后才新建的桶。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-fix">
<code class="sig-name descname"><span class="pre">--fix</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-fix" title="Permalink to this definition">¶</a></dt>
<dd><p>除了检查桶索引，还修复它。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-check-objects">
<code class="sig-name descname"><span class="pre">--check-objects</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-check-objects" title="Permalink to this definition">¶</a></dt>
<dd><p>检查桶：根据对象的实际状态重建桶索引。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-format">
<code class="sig-name descname"><span class="pre">--format</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;format&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-format" title="Permalink to this definition">¶</a></dt>
<dd><p>为某些操作指定输出格式： xml 、 json 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-sync-stats">
<code class="sig-name descname"><span class="pre">--sync-stats</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-sync-stats" title="Permalink to this definition">¶</a></dt>
<dd><p><code class="docutils literal notranslate"><span class="pre">user</span> <span class="pre">stats</span></code> 的选项。若加了此选项，它就会用当前来自用户桶索引的统计信息更新用户的统计信息。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-show-config">
<code class="sig-name descname"><span class="pre">--show-config</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-show-config" title="Permalink to this definition">¶</a></dt>
<dd><p>展示出配置内容。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-show-log-entries">
<code class="sig-name descname"><span class="pre">--show-log-entries</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;flag&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-show-log-entries" title="Permalink to this definition">¶</a></dt>
<dd><p>执行 <code class="docutils literal notranslate"><span class="pre">log</span> <span class="pre">show</span></code> 时，显示或不显示日志条目。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-show-log-sum">
<code class="sig-name descname"><span class="pre">--show-log-sum</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;flag&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-show-log-sum" title="Permalink to this definition">¶</a></dt>
<dd><p>执行 <code class="docutils literal notranslate"><span class="pre">log</span> <span class="pre">show</span></code> 时，显示或不显示日志汇总。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-skip-zero-entries">
<code class="sig-name descname"><span class="pre">--skip-zero-entries</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-skip-zero-entries" title="Permalink to this definition">¶</a></dt>
<dd><p>让 <code class="docutils literal notranslate"><span class="pre">log</span> <span class="pre">show</span></code> 只显示数字字段非零的日志。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-infile">
<code class="sig-name descname"><span class="pre">--infile</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-infile" title="Permalink to this definition">¶</a></dt>
<dd><p>设置时指定要读取的文件。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-categories">
<code class="sig-name descname"><span class="pre">--categories</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;list&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-categories" title="Permalink to this definition">¶</a></dt>
<dd><p>逗号分隔的一系列类目，显示使用情况时需要。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-caps">
<code class="sig-name descname"><span class="pre">--caps</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;caps&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-caps" title="Permalink to this definition">¶</a></dt>
<dd><p>一系列能力，如 “usage=read, write; user=read” 。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-compression">
<code class="sig-name descname"><span class="pre">--compression</span></code><code class="sig-prename descclassname"><span class="pre">=&lt;compression-algorithm&gt;</span></code><a class="headerlink" href="#cmdoption-radosgw-admin-compression" title="Permalink to this definition">¶</a></dt>
<dd><p>归置靶的压缩算法（ lz4|snappy|zlib|zstd ）</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-yes-i-really-mean-it">
<code class="sig-name descname"><span class="pre">--yes-i-really-mean-it</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-yes-i-really-mean-it" title="Permalink to this definition">¶</a></dt>
<dd><p>某些特定操作需要。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-min-rewrite-size">
<code class="sig-name descname"><span class="pre">--min-rewrite-size</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-min-rewrite-size" title="Permalink to this definition">¶</a></dt>
<dd><p>指定桶重写时的最小对象尺寸（默认 4M ）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-max-rewrite-size">
<code class="sig-name descname"><span class="pre">--max-rewrite-size</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-max-rewrite-size" title="Permalink to this definition">¶</a></dt>
<dd><p>指定桶重写时的最大对象尺寸（默认 ULLONG_MAX ）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-min-rewrite-stripe-size">
<code class="sig-name descname"><span class="pre">--min-rewrite-stripe-size</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-min-rewrite-stripe-size" title="Permalink to this definition">¶</a></dt>
<dd><p>指定对象重写时的最小条带尺寸（默认 0 ）。
如果此值设置为 0 ，那么被指定对象被重写后还需重新条带化。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-warnings-only">
<code class="sig-name descname"><span class="pre">--warnings-only</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-warnings-only" title="Permalink to this definition">¶</a></dt>
<dd><p>进行桶超限检查时若加了此选项，仅罗列出那些当前分片内最大对象数接近或超过的桶。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-bypass-gc">
<code class="sig-name descname"><span class="pre">--bypass-gc</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-bypass-gc" title="Permalink to this definition">¶</a></dt>
<dd><p>删除桶时若加了此选项，
则跳过 GC 直接触发对象删除。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-inconsistent-index">
<code class="sig-name descname"><span class="pre">--inconsistent-index</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-inconsistent-index" title="Permalink to this definition">¶</a></dt>
<dd><p>删除桶时若加了此选项、且加了 <code class="docutils literal notranslate"><span class="pre">--bypass-gc</span></code> 选项，
则无视桶索引的一致性。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-max-concurrent-ios">
<code class="sig-name descname"><span class="pre">--max-concurrent-ios</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-max-concurrent-ios" title="Permalink to this definition">¶</a></dt>
<dd><p>进行桶操作时的最大并行 IO 数。影响的操作诸如扫描桶索引，
如罗列、删除；还有所有的扫描、搜索操作，比如捡漏或检查桶索引。
默认值为 32 。</p>
</dd></dl>

</div>
<div class="section" id="id5">
<h2>配额选项<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h2>
<dl class="std option">
<dt id="cmdoption-radosgw-admin-max-objects">
<code class="sig-name descname"><span class="pre">--max-objects</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-max-objects" title="Permalink to this definition">¶</a></dt>
<dd><p>指定最大对象数（负数为禁用）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-max-size">
<code class="sig-name descname"><span class="pre">--max-size</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-max-size" title="Permalink to this definition">¶</a></dt>
<dd><p>指定最大尺寸（单位为 B/K/M/G/T ，负数为禁用）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-quota-scope">
<code class="sig-name descname"><span class="pre">--quota-scope</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-quota-scope" title="Permalink to this definition">¶</a></dt>
<dd><p>配额有效范围（桶、用户）。</p>
</dd></dl>

</div>
<div class="section" id="orphans">
<h2>捡漏（ Orphans ）选项<a class="headerlink" href="#orphans" title="Permalink to this headline">¶</a></h2>
<dl class="std option">
<dt id="cmdoption-radosgw-admin-num-shards">
<code class="sig-name descname"><span class="pre">--num-shards</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-num-shards" title="Permalink to this definition">¶</a></dt>
<dd><p>用多少个分片临时保存扫描信息。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-orphan-stale-secs">
<code class="sig-name descname"><span class="pre">--orphan-stale-secs</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-orphan-stale-secs" title="Permalink to this definition">¶</a></dt>
<dd><p>对象被遗漏多久才被当作孤儿，单位是秒。默认是 86400 （ 24 小时）。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-job-id">
<code class="sig-name descname"><span class="pre">--job-id</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-job-id" title="Permalink to this definition">¶</a></dt>
<dd><p>设置作业标识符（适用于 <code class="docutils literal notranslate"><span class="pre">orphans</span> <span class="pre">find</span></code> ）。</p>
</dd></dl>

</div>
<div class="section" id="orphans-list-jobs">
<h2><code class="docutils literal notranslate"><span class="pre">orphans</span> <span class="pre">list-jobs</span></code> 选项<a class="headerlink" href="#orphans-list-jobs" title="Permalink to this headline">¶</a></h2>
<dl class="std option">
<dt id="cmdoption-radosgw-admin-extra-info">
<code class="sig-name descname"><span class="pre">--extra-info</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-extra-info" title="Permalink to this definition">¶</a></dt>
<dd><p>在作业列表中展示额外信息。</p>
</dd></dl>

</div>
<div class="section" id="id6">
<h2>角色选项<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2>
<dl class="std option">
<dt id="cmdoption-radosgw-admin-role-name">
<code class="sig-name descname"><span class="pre">--role-name</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-role-name" title="Permalink to this definition">¶</a></dt>
<dd><p>要创建角色的名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-path">
<code class="sig-name descname"><span class="pre">--path</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-path" title="Permalink to this definition">¶</a></dt>
<dd><p>角色的路径。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-assume-role-policy-doc">
<code class="sig-name descname"><span class="pre">--assume-role-policy-doc</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-assume-role-policy-doc" title="Permalink to this definition">¶</a></dt>
<dd><p>信任关系策略文档，用于授予一个实体权限，以担任此角色。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-policy-name">
<code class="sig-name descname"><span class="pre">--policy-name</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-policy-name" title="Permalink to this definition">¶</a></dt>
<dd><p>策略文档的名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-policy-doc">
<code class="sig-name descname"><span class="pre">--policy-doc</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-policy-doc" title="Permalink to this definition">¶</a></dt>
<dd><p>权限策略文档。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-path-prefix">
<code class="sig-name descname"><span class="pre">--path-prefix</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-path-prefix" title="Permalink to this definition">¶</a></dt>
<dd><p>用于过滤角色的路径前缀。</p>
</dd></dl>

</div>
<div class="section" id="pubsub">
<h2>桶的通知、发布订阅（PubSub）选项<a class="headerlink" href="#pubsub" title="Permalink to this headline">¶</a></h2>
<dl class="std option">
<dt id="cmdoption-radosgw-admin-topic">
<code class="sig-name descname"><span class="pre">--topic</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-topic" title="Permalink to this definition">¶</a></dt>
<dd><p>桶的通知、发布订阅的主题名字。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-subscription">
<code class="sig-name descname"><span class="pre">--subscription</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-subscription" title="Permalink to this definition">¶</a></dt>
<dd><p>发布订阅的订阅名。</p>
</dd></dl>

<dl class="std option">
<dt id="cmdoption-radosgw-admin-event-id">
<code class="sig-name descname"><span class="pre">--event-id</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-radosgw-admin-event-id" title="Permalink to this definition">¶</a></dt>
<dd><p>一个订阅内的事件 id 。</p>
</dd></dl>

</div>
<div class="section" id="id7">
<h2>实例<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h2>
<p>生成一新用户：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin user create --display-name=&quot;johnny rotten&quot; --uid=johnny
{ &quot;user_id&quot;: &quot;johnny&quot;,
  &quot;rados_uid&quot;: 0,
  &quot;display_name&quot;: &quot;johnny rotten&quot;,
  &quot;email&quot;: &quot;&quot;,
  &quot;suspended&quot;: 0,
  &quot;subusers&quot;: [],
  &quot;keys&quot;: [
        { &quot;user&quot;: &quot;johnny&quot;,
          &quot;access_key&quot;: &quot;TCICW53D9BQ2VGC46I44&quot;,
          &quot;secret_key&quot;: &quot;tfm9aHMI8X76L3UdgE+ZQaJag1vJQmE6HDb5Lbrz&quot;}],
  &quot;swift_keys&quot;: []}
</pre></div>
</div>
<p>删除一用户：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin user rm --uid=johnny
</pre></div>
</div>
<p>重命名用户（改名）：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin user rename --uid=johny --new-uid=joe
</pre></div>
</div>
<p>删除一个用户和与他相关的桶及内容：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin user rm --uid=johnny --purge-data
</pre></div>
</div>
<p>删除一个桶：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin bucket rm --bucket=foo
</pre></div>
</div>
<p>把桶链接到指定用户：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin bucket link --bucket=foo --bucket_id=&lt;bucket id&gt; --uid=johnny
</pre></div>
</div>
<p>切断桶与指定用户的链接：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin bucket unlink --bucket=foo --uid=johnny
</pre></div>
</div>
<p>重命名一个桶：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin bucket link --bucket=foo --bucket-new-name=bar --uid=johnny
</pre></div>
</div>
<p>把一个桶从原来的全局租户空间挪到指定租户：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin bucket link --bucket=/foo --uid=12345678$12345678&#39;
</pre></div>
</div>
<p>把桶链接到指定用户、并更改对象的 ACL ：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin bucket chown --bucket=/foo --uid=12345678$12345678&#39;
</pre></div>
</div>
<p>显示一个桶从 2012 年 4 月 1 日起的日志：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin log show --bucket=foo --date=2012-04-01-01 --bucket-id=default.14193.1
</pre></div>
</div>
<p>显示某用户 2012 年 3 月 1 日（不含）到 4 月 1 日期间的使用情况：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin usage show --uid=johnny \
                --start-date=2012-03-01 --end-date=2012-04-01
</pre></div>
</div>
<p>只显示所有用户的使用情况汇总：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin usage show --show-log-entries=false
</pre></div>
</div>
<p>裁剪掉某用户 2012 年 4 月 1 日之前的使用信息：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ radosgw-admin usage trim --uid=johnny --end-date=2012-04-01
</pre></div>
</div>
</div>
<div class="section" id="id8">
<h2>使用范围<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h2>
<p><strong class="program">radosgw-admin</strong> 是 Ceph 的一部分，这是个伸缩力强、开源、分布式的存储系统，更多信息参见 <a class="reference external" href="https://docs.ceph.com">https://docs.ceph.com</a> 。</p>
</div>
<div class="section" id="id9">
<h2>参考<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h2>
<p><a class="reference internal" href="../ceph/"><span class="doc">ceph</span></a>(8)
<a class="reference internal" href="../radosgw/"><span class="doc">radosgw</span></a>(8)</p>
</div>
</div>



           </div>
           
          </div>
          <footer>
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
        <a href="../../../radosgw/qat-accel/" class="btn btn-neutral float-right" title="使用 QAT 为加密和压缩提速" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
        <a href="../radosgw/" class="btn btn-neutral float-left" title="radosgw – rados REST 风格的网关" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
    </div>

  <hr/>

  <div role="contentinfo">
    <p>
        &#169; Copyright 2016, Ceph authors and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0).

    </p>
  </div> 

</footer>
        </div>
      </div>

    </section>

  </div>
  

  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>

  
  
    
   

</body>
</html>